home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / sort < prev    next >
Encoding:
Text File  |  1996-09-07  |  3.0 KB  |  103 lines
  1.  
  2.  
  3.  
  4.      Sort (V1.3, 2.x, 3.x in C:)    
  5.  
  6.  
  7.      NAME
  8.           Sort - Sort a file.
  9.  
  10.      SYNOPSIS
  11.           1.3:
  12.           Sort [From fromname] [To toname] [COLSTART n]
  13.  
  14.           2.x/3.x:
  15.           Sort [From fromname] [To toname] [COLSTART n] [CASE]
  16.                [Numeric]
  17.  
  18.      DESCRIPTION
  19.             Performs a sort according to the first ASCII value of 
  20.         the beginning characters of an AmigaDOS text file. 
  21.         AmigaDOS treat a string of characters that ends with a 
  22.         linefeed as a single line. Sort will compare each of 
  23.         these lines with each other.
  24.  
  25.             Numbers will always come before letters. Lines will 
  26.         be sorted in ascending order with the 'lower' number or 
  27.         character first and the 'higher characters last (eg 
  28.         1,2,3.....x,y,z). 
  29.  
  30.             Under 1.3 the sort is Case sensitive with capital 
  31.         letters being listed before lower case letters. In all 
  32.         versions 2.x and above there is no case sensitivity.
  33.  
  34.             1.3's sort is not very fast especially on long files. 
  35.         If you have more than 200 lines then you must increase 
  36.         the Stack size. If Sort fails, and you have 1.3, then 
  37.         increase you stack size and you may improve your 
  38.         performance.
  39.  
  40.             If you omit the From argument from Sort, it reads 
  41.         from its standard input, which allows it to be used in 
  42.         pipelines.
  43.  
  44.      KEYWORDS
  45.           FROM
  46.             The AmigaDOS file you whose contents you will sort. 
  47.         If the fromname is the first argument in the command 
  48.         labels then it is optional.
  49.  
  50.           TO
  51.             The AmigaDOS file or device which the sorted lines 
  52.         from fromname will be sent. If you use the same name as 
  53.         fromname Sort will not work. If the toname is the second 
  54.         argument in the command labels then it is optional.
  55.         
  56.           COLSTART n
  57.             This takes a numeric argument which gives the 
  58.         starting column for the sort. All entries to the left of 
  59.         this column will not be considered in the final 
  60.         arrangement.
  61.  
  62.           CASE
  63.             2.X/3.X ONLY: If this option is used, the sort will 
  64.         be case sensitive. In other words, upper case letter will 
  65.         be sorted before lower case ones.
  66.  
  67.  
  68.           NUMERIC
  69.             With this keyword is specified all lines are looked 
  70.         at as numbers. Lines that start with letters are assigned 
  71.         the number zero. If both CASE and NUMERIC are used 
  72.         simultaneously then CASE is ignored.  
  73.  
  74.  
  75.             EXAMPLE
  76.             1. To get a listing of all files sorted by time 
  77.         (i.e., from the earliest to the latest).
  78.  
  79.           list >listfile
  80.           sort listfile colstart 41
  81.  
  82.           or using pipes: list | sort colstart 41
  83.  
  84.  
  85.  
  86.             2. Sort the contents of your Address Book to a file 
  87.         called Sorted Addresses:
  88.  
  89.           SORT "Address Book" "Sorted Addresses"
  90.  
  91.  
  92.  
  93.             3. To print out a sorted Address Book file in the 
  94.         Work:People directory:
  95.  
  96.           SORT "Work:People/Address Book" PRT:
  97.  
  98.  
  99.      
  100.  
  101.  
  102.  
  103.